package libra.openfeign.fallback;

import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.RequestMapping;

/**
 * 基于OpenFeign的客户端负载均衡技术；接口式、注解式编程
 * 使用@FeignClient注解标识OpenFeign定义的服务调用接口类，且该组件必须存在于容器内
 * 		name/value[必选]：指定当前FeignClient的名称。如果项目属于微服务，该属性会视为微服务名(即被调用服务的spring.application.name)，用于服务发现
 * 		url[可选]: 指定FeignClient的调用ip地址，一般用于调试。如果配置该属性，则OpenFeign可以不需要spring-cloud-starter-loadbalancer依赖
 * 		path[可选]: 定义当前FeignClient的统一前缀，当我们项目中配置了server.context-path,server.servlet-path时使用
 *		decode404[可选]:当发生http 404错误时，如果该字段位true，会调用decoder进行解码(正常json返回)，否则抛出FeignException
 * 		configuration[可选]: Feign配置类，可以自定义Feign的Encoder、Decoder、LogLevel、Contract，一般在对单个服务提供方进行定制配置时使用
 * 		fallback[可选]: 定义容错的处理类，当调用远程接口失败或超时时，会调用对应接口的容错逻辑，fallback指定的类必须实现@FeignClient标记的接口
 * 		fallbackFactory[可选]: 工厂类，用于生成fallback类示例，通过这个属性我们可以实现每个接口通用的容错逻辑，减少重复的代码
 *	!!!：fallbackFactory属性用来处理通用的“服务降级”，OpenFeign自身无法独立完成该功能点，需要配合Hystrix处理
 */
@FeignClient( 
	name = "local", url="${local}", path="${server.servlet.context-path}/local",
	fallback = OpenFeignLocalFallbackImpl.class
)
public interface OpenFeignLocalFallback {
	// 测试服务调用请求
	@RequestMapping("exec")
	public Object exec();
	
	// 测试请求超时
	@RequestMapping("timeout")
	public Object timeout();
	
	// 测试请求处理异常
	@RequestMapping("ex")
	public Object ex();
}
